home *** CD-ROM | disk | FTP | other *** search
/ Aminet 41 / Aminet 41 (2001)(Schatztruhe)[!][Feb 2001].iso / Aminet / docs / misc / MuManual.readme < prev    next >
Encoding:
Text File  |  2001-01-03  |  16.1 KB  |  327 lines
  1. Short:    Tutorial, examples, includes, (auto)docs for mmu.library
  2. Author:   thor@math.tu-berlin.de (Thomas Richter)
  3. Uploader: thor@math.tu-berlin.de (Thomas Richter)
  4. Version:  42.1
  5. Type:     docs/misc
  6. Requires: MMULib.lha, Os 2.04, ShowDVI plus recent fonts or GhostScript
  7.  
  8. NOTE:    This is the "Developer Distribution" of the mmu.library. The user
  9.     distribution is in the "MMULib" archive and is required, too.
  10.  
  11. -----------------------------------------------------------------------------
  12. This archive contains a "RKRM style" documentation of the mmu.library,
  13. describing its functions and its purposes. It contains various program
  14. examples and gives the basic insight into the library mechanisms.
  15.  
  16. The manual is included in "dvi" and "postscript" form, you need either a
  17. postscript printer (most recent laser printers include a postscript
  18. interpreter), a postscript interpreter like "ghostscript" from the Aminet,
  19. or a recent TeX installation to print the "dvi" file itself. The latter
  20. requires the installation of the relatively new "ec" fonts which can be
  21. found at the CTAN servers, e.g. ftp.dante.de.
  22.  
  23. -----------------------------------------------------------------------------
  24.  
  25. Purpose and goal of this library:
  26.  
  27. The mmu.library is a basis for MMU (memory management) related functions the 
  28. MC68K family can perform. Up to now certain hacks are available that program 
  29. the MMU themselves (Enforcer,CyberGuard,GuardianAngle,SetCPU,Shapeshifter,
  30. VMM,GigaMem...). 
  31. It's therefore not unexpected that these tools conflict with each other.
  32. There's up to now no Os support for the MMU at all - the gap this mmu.library
  33. fills.
  34.  
  35. The goal is to provide a basis of functions to address and program the MMU in
  36. a hardware independent, Os friendly fashion. Hence, the new version of the
  37. Enforcer, called MuForce, will work together with virtual memory, and others.
  38.  
  39. The mmu.library is also the basis for a virtual memory project, the 
  40. memory.library. Even though the mmu.library does not provide virtual memory
  41. itself, it builds the basics to allow an easy implementation and to avoid the
  42. hacks required by other implementations so far.
  43.  
  44. ------------------------------------------------------------------------------
  45.  
  46.                          The THOR-Software Licence (v2, 24th June 1998)
  47.  
  48.  
  49. This License applies to the computer programs known as the "mmu.library" 
  50. and its sources. The "Program", below, refers to such program. The
  51. "Archive" refers to the package of distribution, as prepared by the author
  52. of the Program, Thomas Richter. Each licensee is addressed as "you".
  53.  
  54.  
  55.  
  56. The Program and the data in the archive are freely distributable
  57. under the restrictions stated below, but are also Copyright (c)
  58. Thomas Richter.
  59.  
  60. Distribution of the Program, the Archive and the data in the Archive by a
  61. commercial organization without written permission from the author to any
  62. third party is prohibited if any payment is made in connection with such
  63. distribution, whether directly (as in payment for a copy of the Program) or
  64. indirectly (as in payment for some service related to the Program, or
  65. payment for some product or service that includes a copy of the Program
  66. "without charge"; these are only examples, and not an exhaustive enumeration
  67. of prohibited activities).
  68.  
  69.  
  70. However, the following methods of distribution
  71. involving payment shall not in and of themselves be a violation of this
  72. restriction:
  73.  
  74.  
  75. (i) Posting the Program on a public access information storage and
  76. retrieval service for which a fee is received for retrieving information
  77. (such as an on-line service), provided that the fee is not
  78. content-dependent (i.e., the fee would be the same for retrieving the same
  79. volume of information consisting of random data).
  80.  
  81.  
  82. (ii) Distributing the Program on a CD-ROM, provided that
  83.  
  84. a) the Archive is reproduced entirely and verbatim on such CD-ROM, including
  85. especially this licence agreement;
  86.  
  87. b) the CD-ROM is made available to the public for a nominal fee only,
  88.  
  89. c) a copy of the CD is made available to the author for free except for
  90. shipment costs, and
  91.  
  92. d) provided further that all information on such CD-ROM is redistributable
  93. for non-commercial purposes without charge.
  94.  
  95.  
  96. Redistribution of a modified version of the Archive, the Program or the
  97. contents of the Archive is prohibited in any way, by any organization,
  98. regardless whether commercial or non-commercial. Everything must be kept
  99. together, in original and unmodified form.
  100.  
  101.  
  102.  
  103.  
  104. Limitations.
  105.  
  106.  
  107. THE PROGRAM IS PROVIDED TO YOU "AS IS", WITHOUT WARRANTY. THERE IS NO
  108. WARRANTY FOR THE PROGRAM, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT
  109. LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
  110. PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS. THE ENTIRE
  111. RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD
  112. THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY
  113. SERVICING, REPAIR OR CORRECTION.
  114.  
  115.  
  116. IF YOU DO NOT ACCEPT THIS LICENCE, YOU MUST DELETE THE PROGRAM, THE ARCHIVE
  117. AND ALL DATA OF THIS ARCHIVE FROM YOUR STORAGE SYSTEM. YOU ACCEPT THIS
  118. LICENCE BY USING OR REDISTRIBUTING THE PROGRAM.
  119.  
  120.  
  121.                                                         Thomas Richter
  122.  
  123. -----------------------------------------------------------------------------
  124.  
  125. So long,
  126.     Thomas            (December 2000)
  127.  
  128.  
  129. ============================= Archive contents =============================
  130.  
  131. Original  Packed Ratio    Date     Time    Name
  132. -------- ------- ----- --------- --------  -------------
  133.      628     270 57.0% 15-Apr-00 21:47:08 +Autodocs.info
  134.     3375    1359 59.7% 30-Mar-00 21:33:56 +68040
  135.     2912    1246 57.2% 29-Mar-00 23:12:42 +68040.doc
  136.      473     221 53.2% 29-Mar-00 23:55:30 +68040.info
  137.     6792    2199 67.6% 30-Mar-00 21:33:56 +680x0
  138.     5762    2049 64.4% 29-Mar-00 23:12:40 +680x0.doc
  139.      473     221 53.2% 29-Mar-00 23:55:30 +680x0.info
  140.     6541    2486 61.9% 30-Mar-00 21:33:58 +disassembler
  141.     5617    2315 58.7% 29-Mar-00 23:12:54 +disassembler.doc
  142.      473     220 53.4% 29-Mar-00 23:55:30 +disassembler.info
  143.    36015   13339 62.9% 16-Mar-00 23:03:52 +exceptions.doc
  144.    10323    2762 73.2% 30-Mar-00 21:33:56 +fpsp
  145.     9887    2631 73.3% 29-Mar-00 23:12:46 +fpsp.doc
  146.      473     220 53.4% 29-Mar-00 23:55:30 +fpsp.info
  147.    14837    4907 66.9% 20-Nov-99 15:22:44 +memory.doc
  148.   145747   39095 73.1% 08-Oct-00 15:01:52 +mmu
  149.   124014   36642 70.4% 08-Oct-00 14:58:22 +mmu.doc
  150.      473     220 53.4% 29-Mar-00 23:55:30 +mmu.info
  151.      628     273 56.5% 15-Apr-00 21:47:08 +BMAPs.info
  152.       17      17  0.0% 16-Nov-99 16:02:00 +68040_lib.bmap
  153.       59      59  0.0% 16-Nov-99 16:02:30 +680x0_lib.bmap
  154.       42      42  0.0% 16-Nov-99 16:01:10 +Disassembler_lib.bmap
  155.      265     197 25.6% 16-Nov-99 16:00:20 +MMU_BMAP.notes
  156.      750     661 11.8% 16-Nov-99 16:05:14 +MMU_BMAP.notes.info
  157.     1258     624 50.3% 16-Nov-99 15:54:28 +mmu_lib.bmap
  158.      628     271 56.8% 15-Apr-00 21:47:08 +C_Sources.info
  159.     6222    1298 79.1% 31-Oct-99 12:45:26 +FPU.c
  160.    10359    2876 72.2% 22-Mar-00 21:55:42 +IndirectTest.c
  161.    13347    3424 74.3% 15-Mar-99 00:08:34 +MMUCacheTest.c
  162.    13476    3870 71.2% 03-Jun-99 20:49:22 +MuContextTest.c
  163.    13675    3313 75.7% 28-Nov-99 15:36:32 +MuFastChip.c
  164.    21264    5060 76.2% 28-Nov-99 15:34:40 +MuFastRom.c
  165.    39166    9388 76.0% 28-Nov-99 15:35:36 +MuFastZero.c
  166.     8966    2589 71.1% 11-Jul-99 14:34:10 +MuIndirectTest.c
  167.     4426    1468 66.8% 31-Oct-99 12:45:36 +MuLockLib.c
  168.    21850    5843 73.2% 26-May-99 22:22:38 +MuRemapTest.c
  169.    15635    3597 76.9% 28-Nov-99 15:27:02 +MuScan.c
  170.    22359    4366 80.4% 28-Nov-99 15:33:32 +MuSetCacheMode.c
  171.     3338     899 73.0% 07-Feb-99 01:12:18 +SCSIDMATest.c
  172.    56804   27929 50.8% 21-Apr-00 17:12:06 +mmu.library
  173.      628     271 56.8% 15-Apr-00 21:47:08 +Include.info
  174.      794     258 67.5% 31-Oct-99 12:34:24 +68040_lib.fd
  175.      783     249 68.1% 31-Oct-99 12:34:46 +680x0_lib.fd
  176.      391     248 36.5% 31-Oct-99 12:13:58 +68040_protos.h
  177.      450     267 40.6% 31-Oct-99 12:14:50 +680x0_protos.h
  178.      475     283 40.4% 31-Oct-99 12:13:20 +disassembler_protos.h
  179.     5319    1225 76.9% 26-Mar-00 00:22:08 +mmu_protos.h
  180.      782     246 68.5% 31-Oct-99 12:34:00 +disassembler_lib.fd
  181.     2088     683 67.2% 31-Oct-99 12:37:02 +68040.h
  182.     2107     692 67.1% 31-Oct-99 12:37:24 +68040.i
  183.     2817     921 67.3% 31-Oct-99 12:38:24 +680x0.h
  184.     2640     886 66.4% 31-Oct-99 12:38:46 +680x0.i
  185.     2609     905 65.3% 31-Oct-99 12:36:34 +disassembler.h
  186.     2757     926 66.4% 31-Oct-99 12:36:00 +disassembler.i
  187.      105      77 26.6% 28-Aug-99 16:30:44 +68040_lvo.i
  188.      215     112 47.9% 28-Aug-99 16:30:28 +680x0_lvo.i
  189.       68      64  5.8% 02-Jul-99 20:05:54 +disassembler_lvo.i
  190.     2105     615 70.7% 26-Mar-00 00:24:20 +mmu_lvo.i
  191.     4367    1474 66.2% 16-Sep-00 21:23:54 +alerts.h
  192.     4101    1411 65.5% 02-Apr-00 17:07:14 +alerts.i
  193.     2071     664 67.9% 02-Apr-00 17:07:12 +config.h
  194.     2435     723 70.3% 02-Apr-00 17:07:12 +config.i
  195.     8191    3057 62.6% 02-Apr-00 17:07:14 +context.h
  196.     8240    3080 62.6% 02-Apr-00 17:07:14 +context.i
  197.     2015     770 61.7% 02-Apr-00 17:07:12 +descriptor.h
  198.     2111     830 60.6% 02-Apr-00 17:07:12 +descriptor.i
  199.    11182    3766 66.3% 02-Apr-00 17:07:14 +exceptions.h
  200.    11249    3775 66.4% 02-Apr-00 17:07:14 +exceptions.i
  201.     1817     594 67.3% 02-Apr-00 17:07:14 +mmubase.h
  202.     1935     624 67.7% 02-Apr-00 17:07:14 +mmubase.i
  203.     7040    2410 65.7% 02-Apr-00 17:07:12 +mmutags.h
  204.     6988    2441 65.0% 02-Apr-00 17:07:14 +mmutags.i
  205.     3006     982 67.3% 26-Mar-00 00:19:56 +mmu_lib.fd
  206.      412     225 45.3% 12-Aug-99 20:07:24 +68040_pragmas.h
  207.      724     283 60.9% 31-Oct-99 12:30:08 +680x0_pragmas.h
  208.      587     268 54.3% 12-Aug-99 20:06:20 +disassembler_pragmas.h
  209.     7440    1436 80.6% 26-Mar-00 00:24:36 +mmu_pragmas.h
  210.      220     125 43.1% 12-Aug-99 20:05:58 +68040.h
  211.      220     128 41.8% 31-Oct-99 12:31:34 +680x0.h
  212.      270     135 50.0% 12-Aug-99 20:04:56 +disassembler.h
  213.      141     106 24.8% 06-Sep-98 13:37:58 +mmu.h
  214.      628     277 55.8% 15-Apr-00 21:47:08 +Manual.info
  215.   268200  108346 59.6% 15-Jul-00 15:37:02 +mmudoc.dvi
  216.      937     460 50.9% 15-Apr-00 21:46:16 +mmudoc.dvi.info
  217.   437879  165937 62.1% 15-Jul-00 15:38:26 +mmudoc_360.ps
  218.   513059  199540 61.1% 15-Jul-00 15:39:18 +mmudoc_600.ps
  219.     2008    1015 49.4% 02-Apr-00 17:00:12 +ReadMe
  220.      523     268 48.7% 15-Apr-00 21:42:14 +ReadMe.info
  221.     5305    2360 55.5% 03-Dec-00 20:16:10 +MuManual.readme
  222.    61479   23741 61.3% 03-Dec-00 19:37:44 +ReadMe
  223.      628     275 56.2% 15-Apr-00 21:47:08 +Shell_Only.info
  224.      376     295 21.5% 21-Aug-99 14:47:14 +CheckFpu
  225.       84      74 11.9% 02-Jul-99 18:57:50 +ClearTTx
  226.     3764    2042 45.7% 17-Jan-00 21:32:08 +FastIEEE
  227.     1060     625 41.0% 28-Aug-99 18:22:22 +FPU
  228.     2388    1394 41.6% 22-Mar-00 21:55:52 +IndirectTest
  229.    16900    9346 44.6% 15-Mar-99 00:08:26 +MMUCacheTest
  230.     4788    2537 47.0% 01-Jun-99 20:28:38 +MuContextTest
  231.     3240    1640 49.3% 11-Jul-99 14:33:58 +MuIndirectTest
  232.     7056    4030 42.8% 26-May-99 22:22:42 +MuRemapTest
  233.      168     164  2.3% 02-Jul-99 19:15:34 +PrintBusError
  234.      728     426 41.4% 17-Sep-98 21:43:20 +PrintTTX
  235.      232     204 12.0% 02-Jul-99 20:47:26 +ResetBusError
  236.     1320     869 34.1% 15-Nov-98 17:56:44 +SCSIDMATest
  237.      260     209 19.6% 04-Oct-98 00:27:58 +TestMMU
  238.      628     274 56.3% 15-Apr-00 21:47:08 +VBCC.info
  239.       45      45  0.0% 31-Aug-99 03:34:32 +68040_lib.FD_lvo.s
  240.       45      45  0.0% 30-Nov-99 18:56:28 +68040_lvo.s
  241.      170      84 50.5% 31-Aug-99 03:34:34 +680x0_lib.FD_lvo.s
  242.      170      84 50.5% 30-Nov-99 18:57:10 +680x0_lvo.s
  243.      104      73 29.8% 31-Aug-99 03:34:32 +disassembler_lib.FD_lvo.s
  244.      104      73 29.8% 30-Nov-99 18:58:02 +Disassembler_lvo.s
  245.     2810     696 75.2% 30-Nov-99 18:51:46 +MMU_lib.FD_lvo.s
  246.       45      45  0.0% 31-Aug-99 03:34:32 +68040_lib.FD_lvo.s
  247.       45      45  0.0% 30-Nov-99 18:56:34 +68040_lvo.s
  248.      170      84 50.5% 31-Aug-99 03:34:34 +680x0_lib.FD_lvo.s
  249.      170      84 50.5% 30-Nov-99 18:57:14 +680x0_lvo.s
  250.      104      73 29.8% 31-Aug-99 03:34:32 +disassembler_lib.FD_lvo.s
  251.      104      73 29.8% 30-Nov-99 18:58:06 +Disassembler_lvo.s
  252.     2810     696 75.2% 30-Nov-99 18:52:22 +MMU_lib.FD_lvo.s
  253.       48      47  2.0% 31-Aug-99 03:34:34 +68040_lib.FD_lvo.s
  254.       48      47  2.0% 30-Nov-99 18:56:36 +68040_lvo.s
  255.      182      87 52.1% 31-Aug-99 03:34:34 +680x0_lib.FD_lvo.s
  256.      182      87 52.1% 30-Nov-99 18:57:18 +680x0_lvo.s
  257.      110      71 35.4% 31-Aug-99 03:34:32 +disassembler_lib.FD_lvo.s
  258.      110      71 35.4% 30-Nov-99 18:58:14 +Disassembler_lvo.s
  259.     2966     699 76.4% 30-Nov-99 18:52:58 +MMU_lib.FD_lvo.s
  260.       66      63  4.5% 31-Aug-99 03:34:34 +68040_lib.FD_lvo.asm
  261.       66      63  4.5% 30-Nov-99 18:56:40 +68040_lvo.asm
  262.      191     100 47.6% 31-Aug-99 03:34:34 +680x0_lib.FD_lvo.asm
  263.      191     100 47.6% 30-Nov-99 18:57:24 +680x0_lvo.asm
  264.      125      83 33.6% 31-Aug-99 03:34:32 +disassembler_lib.FD_lvo.asm
  265.      125      83 33.6% 30-Nov-99 18:58:20 +Disassembler_lvo.asm
  266.     2831     711 74.8% 30-Nov-99 18:53:58 +MMU_lib.FD_lvo.asm
  267.      176      46 73.8% 30-Nov-99 18:56:32 +68040.dir
  268.      196     133 32.1% 30-Nov-99 18:56:32 +68040.lib
  269.      176      46 73.8% 30-Nov-99 18:56:36 +68040_040.dir
  270.      196     133 32.1% 30-Nov-99 18:56:36 +68040_040.lib
  271.      980     375 61.7% 30-Nov-99 18:56:38 +68040_PPC.a
  272.       88      27 69.3% 30-Nov-99 18:56:42 +68040_WOS.dir
  273.      248     177 28.6% 30-Nov-99 18:56:42 +68040_WOS.lib
  274.      440      87 80.2% 30-Nov-99 18:57:14 +680x0.dir
  275.      584     212 63.6% 30-Nov-99 18:57:14 +680x0.lib
  276.      440      87 80.2% 30-Nov-99 18:57:18 +680x0_040.dir
  277.      584     212 63.6% 30-Nov-99 18:57:18 +680x0_040.lib
  278.     2988     548 81.6% 30-Nov-99 18:57:24 +680x0_PPC.a
  279.      352      72 79.5% 30-Nov-99 18:57:30 +680x0_WOS.dir
  280.      968     266 72.5% 30-Nov-99 18:57:30 +680x0_WOS.lib
  281.      264      70 73.4% 30-Nov-99 18:58:06 +Disassembler.dir
  282.      384     178 53.6% 30-Nov-99 18:58:06 +Disassembler.lib
  283.      264      70 73.4% 30-Nov-99 18:58:14 +Disassembler_040.dir
  284.      384     178 53.6% 30-Nov-99 18:58:14 +Disassembler_040.lib
  285.     1762     501 71.5% 30-Nov-99 18:58:20 +Disassembler_PPC.a
  286.      176      55 68.7% 30-Nov-99 18:58:22 +Disassembler_WOS.dir
  287.      540     241 55.3% 30-Nov-99 18:58:22 +Disassembler_WOS.lib
  288.     5632     772 86.2% 30-Nov-99 18:52:18 +MMU.dir
  289.     9488    1686 82.2% 30-Nov-99 18:52:18 +MMU.lib
  290.     5632     769 86.3% 30-Nov-99 18:52:54 +MMU_040.dir
  291.     9512    1685 82.2% 30-Nov-99 18:52:54 +MMU_040.lib
  292.    42904    3843 91.0% 30-Nov-99 18:53:54 +MMU_PPC.a
  293.     5544     757 86.3% 30-Nov-99 18:54:32 +MMU_WOS.dir
  294.    16488    1778 89.2% 30-Nov-99 18:54:32 +MMU_WOS.lib
  295.      704     125 82.2% 30-Nov-99 19:17:30 +MuAutoLib_000.dir
  296.     1820     399 78.0% 30-Nov-99 19:17:30 +MuAutoLib_000.lib
  297.      704     125 82.2% 30-Nov-99 19:18:48 +MuAutoLib_010.dir
  298.     1820     399 78.0% 30-Nov-99 19:18:48 +MuAutoLib_010.lib
  299.      704     125 82.2% 30-Nov-99 19:20:08 +MuAutoLib_020.dir
  300.     1820     399 78.0% 30-Nov-99 19:20:08 +MuAutoLib_020.lib
  301.      704     125 82.2% 30-Nov-99 19:21:18 +MuAutoLib_030.dir
  302.     1820     399 78.0% 30-Nov-99 19:21:18 +MuAutoLib_030.lib
  303.      704     124 82.3% 30-Nov-99 19:16:18 +MuAutoLib_040.dir
  304.     1820     399 78.0% 30-Nov-99 19:16:18 +MuAutoLib_040.lib
  305.      704     125 82.2% 30-Nov-99 19:22:36 +MuAutoLib_060.dir
  306.     1820     399 78.0% 30-Nov-99 19:22:36 +MuAutoLib_060.lib
  307.     6240     840 86.5% 30-Nov-99 19:24:06 +MuAutoLib_PPC.a
  308.     1408     200 85.7% 30-Nov-99 19:25:30 +MuAutoLib_wos.dir
  309.     5456     523 90.4% 30-Nov-99 19:25:30 +MuAutoLib_wos.lib
  310.      371     192 48.2% 30-Nov-99 18:58:24 +DisassemblerBase.c
  311.       40      40  0.0% 30-Nov-99 18:58:24 +DisassemblerBaseVer.c
  312.      245     144 41.2% 30-Nov-99 19:15:12 +HVC.h
  313.      324     187 42.2% 30-Nov-99 18:56:42 +MC68040Base.c
  314.       35      35  0.0% 30-Nov-99 18:56:44 +MC68040BaseVer.c
  315.      324     186 42.5% 30-Nov-99 18:57:32 +MC680x0Base.c
  316.       35      35  0.0% 30-Nov-99 18:57:32 +MC680x0BaseVer.c
  317.      290     181 37.5% 30-Nov-99 18:54:34 +MMUBase.c
  318.       31      31  0.0% 30-Nov-99 18:54:34 +MMUBaseVer.c
  319.     1763     926 47.4% 30-Nov-99 05:37:54 +LiesMich
  320.     1800    1187 34.0% 12-Oct-99 19:56:48 +LiesMich.info
  321.     2443    1147 53.0% 30-Nov-99 05:35:42 +MMULib.readme
  322.     1800    1187 34.0% 12-Oct-99 19:56:48 +MMULib.readme.info
  323.     1667     835 49.9% 30-Nov-99 05:37:28 +ReadMe
  324.     1800    1187 34.0% 12-Oct-99 19:56:48 +ReadMe.info
  325. -------- ------- ----- --------- --------
  326.  2239625  786771 64.8% 12-Dec-100 08:14:32   192 files
  327.